.\" Manpage for cgalmesh.
.\" Contact fangqq@gmail.com to correct errors or typos.
.TH man 7 "30 June 2020" "1.0" "cgalmesh man page"
.SH NAME
cgalmesh \- 3D mesh generation from volumetric image
.SH SYNOPSIS
cgalmesh input.inr output.mesh <angle|30> <surf-size|6> <approx|4> 
<rad-edge-ratio|3> <tetra-size|8> <randomseed|-1>
.SH DESCRIPTION
The cgalmesh utility is a volume-to-tetrahedral-mesh converter based 
on the CGAL library (http://cgal.org). This utility is capable 
of reading a binary, multi-labled or gray-scale based 3D volumetric 
image and output a tetrahedral mesh conforming to the volume, with 
each region labeled correspondingly to the volume labels.

Please see https://doc.cgal.org/latest/Mesh_3/ for details regarding
the underlying algorithm.
.SH OPTIONS
This program accepts the following input parameters:
.TP
\fBinput.inr\fR|(required)
The input data file in the INR format
.TP
\fBoutput.mesh\fR|(required)
The output mesh file in the MEDIT format
.TP
\fBangle\fR|(optional, default: 30)
Lower-bound of the angles (in degree) in surface triangles
.TP
\fBsurf-size\fR|(optional, default: 6)
Lower-bound of the edge-length (in voxel unit) in surface triangles
.TP
\fBapprox\fR|(optional, default: 4)
Upper-bound of the deviation distance (in voxel unit) of the surface triangles to the voxelated boundaries
.TP
\fBrad-edge-ratio\fR|(optional, default: 3)
Upper-bound of the radius-to-edge ratio of the surface triangles
.TP
\fBtetra-size\fR|(optional, default: 8)
Lower-bound of the tetrahedron volume (in voxel^3) of the 3D mesh
.TP
\fBrandomseed\fR|(optional, default: -1)
Random number generator seed (large positive integer, -1 to use system clock)
.SH SEE ALSO
cgalsurf(7), cgalsimp2(7), cgalpoly(7), cork(7), meshfix(7), jmeshlib(7)
.SH AUTHOR
Qianqian Fang (fangqq@gmail.com) and Peter Varga
